home *** CD-ROM | disk | FTP | other *** search
/ NetNews Offline 2 / NetNews Offline Volume 2.iso / news / comp / lang / c-part2 / 15260 < prev    next >
Encoding:
Internet Message Format  |  1996-08-05  |  2.1 KB
  1. Path: nntp.teleport.com!usenet
  2. From: GHouck <hksys@teleport.com>
  3. Newsgroups: comp.lang.c
  4. Subject: Re: COLLEGE PROFESSORS! #3
  5. Date: 18 Apr 1996 07:41:12 GMT
  6. Organization: systems hk
  7. Message-ID: <4l4rmo$r1v@nadine.teleport.com>
  8. References: <8BEC556.02C70031C6.uuout@sourcebbs.com>
  9. NNTP-Posting-Host: ip-pdx07-11.teleport.com
  10. Mime-Version: 1.0
  11. Content-Type: text/plain; charset=us-ascii
  12. Content-Transfer-Encoding: 7bit
  13. X-Mailer: Mozilla 1.22 (Windows; I; 32bit)
  14.  
  15. david.mohorn@sourcebbs.com (DAVID MOHORN) wrote:
  16. >My last complaint tonight is how the instructor comments his code--I
  17. >can't take it any more!!!
  18. [snip]
  19. [snip]
  20. >This is how his code looks:
  21. >
  22. >comment
  23. [snip]
  24. [snip]
  25. >The code is endlessly over commented!  I mean, every "comment" is 80
  26. >characters long written in paragraph format!  Code statements are buried
  27. [snip]
  28. [snip snip snip ...]
  29.  
  30. A few points.  I don't usually agree with the sages in this 
  31. group concerning appropriateness of postings, however, I'll make 
  32. an exception in your case:
  33.  
  34.   1.  Who ARE you?  And what does Visual Basic have to do with C?
  35.   2.  In one example you were overly concerned with the speed of
  36.       a few too many tests, yet in the last you were willing to
  37.       shift potentially hundreds of strings up an array?  It is
  38.       very common in the real world to 'mark' things as deleted;
  39.       less common to do as you suggest.
  40.   3.  As to comments:  the only thing worse than too few comments,
  41.       are bad or content-less comments.  The quantity is not the
  42.       issue; the quality is.
  43.   4.  Until you're in a position to teach a programming class,
  44.       remember (as another respondent stated) the goal at the
  45.       elementary level is not to teach the most efficient or
  46.       elegant method, but to expose the underlying concepts.
  47.  
  48. You remind of those letters to the editor -- after an article
  49. describing some algorithm or concept -- offering a much faster, more
  50. elegant, shorter way to perform the task, when that wasn't the issue
  51. at all.  There's always a faster and sweeter way to do something,
  52. but we can't all think of them at the time ... we've got real-world
  53. deadlines to meet.
  54.  
  55. Yours, Geoff Houck
  56.  
  57.